<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="author" content="lijun; 67086071; zwlijun@qq.com" />
<title>XLib.UI.JSelect</title>
<link href="css/api.css" rel="stylesheet" type="text/css" />
</head>

<body>
  <table>
    <caption>Constructor Summary</caption>
    <tr>
      <th>JSelect</th>
      <td>XLib.UI.JSelect()</td>
      <td class="desc">构建一个新的JSelect实例。</td>
    </tr>
  </table>
  <table>
    <caption>Property Summary</caption>
    <tr>
      <th>N/A</th>
      <td>N/A</td>
      <td class="desc">N/A</td>
    </tr>
  </table>
  <table>
    <caption>Method Summary</caption>
    <tr>
      <th>void</th>
      <td><a href="#setEventHandler">setEventHandler(Object _events)</a></td>
      <td class="desc">设置事件句柄。</td>
    </tr>
    <tr>
      <th>void</th>
      <td><a href="#setAttributes">setAttributes(Object attrs)</a></td>
      <td class="desc">设置属性。</td>
    </tr>
    <tr>
      <th>void</th>
      <td><a href="#create">create(String htmlFor)</a></td>
      <td class="desc">创建JSelect。</td>
    </tr>
    <tr>
      <th>void</th>
      <td><a href="#add">add(JOption option)</a></td>
      <td class="desc">添加一个option。</td>
    </tr>
    <tr>
      <th>void</th>
      <td><a href="#remove">remove(int index)</a></td>
      <td class="desc">移除一个option。</td>
    </tr>
    <tr>
      <th>void</th>
      <td><a href="#done">done()</a></td>
      <td class="desc">完成调用。</td>
    </tr>
  </table>
  <hr />
  <pre>
    <h4>void setEventHandler(Object _events)<a name="setEventHandler"></a></h4>
    设置事件句柄。
    参数：_events 事件对象集
             {
                $onchange : fnHandler
                $onclick : fnHandler
                $ondblclick : fnHandler
                $onmouseover : fnHandler
                $onmouseout : fnHandler
                $onmousedown : fnHandler
                $onmousemove : fnHandler
                $onfocus : fnHandler
                $onblur : fnHandler
                $onkeyup : fnHandler
                $onkeydown : fnHandler
                $onkeypress : fnHandler
             }
    返回：
    示例：jsel.setEventHandler({$onchange : doChanged});
  </pre>
  <pre>
    <h4>void setAttributes(Object attrs)<a name="setAttributes"></a></h4>
    设置属性。
    参数：attrs 属性集
             {
                String $name 名称
                String $id ID
                int width 宽度
                int height 高度
                int optionHeight 选项高度
                int offsetX x偏移值
                int offsetY y偏移值
             }
    返回：
    示例：jsel.setAttributes({$id:"test", $name:"test", width:200, height:20, offsetX:-2, offsetY:20});
  </pre>
  <pre>
    <h4>void create(String htmlFor)<a name="create"></a></h4>
    设置属性。
    参数：htmlFor - 容器节点
    返回：
    示例：jsel.create("sel");
  </pre>
  <pre>
    <h4>void add(JOption option)<a name="add"></a></h4>
    添加一个option。
    参数：option - 下拉选项
    返回：
    示例：jsel.add(new XLib.UI.JOption("北京", "BJ"));
  </pre>
  <pre>
    <h4>void remove(int index)<a name="remove"></a></h4>
    移除一个option。
    参数：index - 索引
    返回：
    示例：jsel.remove(1);
  </pre>
  <pre>
    <h4>void done()<a name="done"></a></h4>
    完成调用。
    参数：
    返回：
    示例：jsel.done();
  </pre>
  <pre>
完整示例：
var jsel = new XLib.UI.JSelect();
jsel.setEventHandler({$onchange : doChanged});
jsel.setAttributes({$id:"test", $name:"test", width:200, height:20, offsetX:-2, offsetY:20});
jsel.create("sel");
jsel.add(new XLib.UI.JOption("请选择", ""));
jsel.add(new XLib.UI.JOption("深圳", "SZ", true, true));
jsel.add(new XLib.UI.JOption("北京", "BJ"));
jsel.add(new XLib.UI.JOption("上海", "SH"));
jsel.add(new XLib.UI.JOption("广州", "GZ"));
jsel.add(new XLib.UI.JOption("长沙", "CS"));
jsel.done();
  </pre>
</body>
</html>
